环境部署

SuperMap iDesktopX  内置了扩展开发模板（SampleCodeTemplates）。在配置好JDK以及开发环境后，在产品包/templates目录中解压此模板并通过简单配置，即可快速开启扩展功能的开发。

安装JDK

SuperMap iDesktopX 兼容JDK8和JDK17，推荐将JDK8作为默认选择。当您需体验全新的画布风格时，请升级至JDK 17以获得最佳效果。下文将以JDK8 为例，介绍具体的安装与配置步骤。

  1. 下载JDK8：根据硬件系统下载JDK8压缩包。

  2. 解压JDK8压缩包，如：

  3. 设置系统环境变量：
    1. 打开计算机系统环境变量设置对话框。
    2. 在系统变量分组中新建JAVA_HOME变量，变量值为JDK压缩包的解压路径，如“D:\soft\JDK8\openlogic-openjdk-8u462-b08-windows-x64”。

    3. 在系统变量分组中新建ClASSPATH变量，变量值为：%JAVA HOME%\lib\dt.jar;%JAVA HOME%\lib\tools.jar;

    4. 在Path系统变量中增加 %JAVA_HOME%\bin。

安装IDEA

开发工具推荐使用IDEA，建议安装的IDEA为2024.2或更高版本。下文以2025.2.3版本为例，为您介绍IDEA的安装与配置。

  1. 在IDEA官网下载IntelliJ IDEA Community Edition软件后，双击下载的.exe文件进行安装。

  2. 设置Project的JDK环境为8。如下图：在File->Project Structure->Project->SDK的下拉列表中选择1.8。

开发工程配置

推荐方式

直接通过视图选项卡中的新建二次开发工程功能，快速构建二次开发工程。该方式高效便捷，无需手动添加桌面依赖，可以选择开发工程存放路径、自定义项目参数；并且还可导入二次开发示例代码，方便用户快速进行扩展开发。

  1. 新建二次开发工程：点击视图选项卡->自定义组->新建二次开发工程按钮，在弹出的对话框中根据提示设置工程名称、版本、作者、模板类型、存储路径等。其中，
    • 模板类型：提供 CtrlAction 和 GPA 两种类型，CtrlAction 用于扩展桌面基础功能，GPA 用于扩展工具箱中的工具。
    • 导入二次开发示例代码：选中后可将软件包提供的二次开发示例代码导入新建的工程中，启动工程时桌面将同时加载示例代码选项卡。

  2. 工程打开到IDEA：新建工程后，将弹出提示是否打开IDEA的对话框，点击是即可。或在输出窗口中点击打开工程，将直接跳转至IDEA 。如下图所示，SampleCode 目录为新建工程。
    • 若勾选了导入二次开发示例代码，工程中还会加载二次开发示例模板 SampleCodeTemplates 目录。

    • 若未自动打开IDEA，请手动启动IDEA程序，并通过IDEA->File->Open功能选择并打开新建的工程目录。

  3. 选择对应JDK环境的启动配置：若JDK环境为1.8则启动配置选择MyStartUp，若JDK环境17，则选择MyStartUp_JDK17。

  4. 编译：单击IDEA工具栏中的 Run 或者 Debug 按钮启动编译。编译成功后将自动启动 SuperMap iDesktopX ，并在Ribbon 中增加二次开发选项卡。
    • 若模板类型选中GPA，则二次开发选项卡以及工具箱中将增加GPA工具示例分组，分组中包括删除重复点和设置坐标系两个示例工具。
      图：二次开发选项卡 图：工具箱
    • 若勾选导入二次开发示例代码复选框，Ribbon 中还会增加示例代码选项卡。

其他方式

直接在IDEA中打开扩展开发示例模板，此方式需要手动添加依赖。

  1. 解压示例模板压缩包：在产品包\templates目录中解压SampleCodeTemplates.zip压缩包。

  2. 打开模板工程：IDEA->File->Open->选择产品包\templates\SampleCodeTemplates目录，并打开扩展开发示例模板工程。

  3. 添加桌面依赖：
    1. 选择File->Project Structure->Libraries->添加->Java按钮。
    2. 弹出的Select Library Files对话框中选择%SuperMap iDesktopX 产品包%/bin文件夹。
    3. 在弹出的Choose Module对话框中选择需要添加依赖的模块后，点击确定即可完成依赖添加。
    4. 重复上述步骤继续添加以下依赖：
      • %SuperMap iDesktopX 产品包%/bundles/idesktop_bundles/
      • %SuperMap iDesktopX 产品包%/bundles/require_bundles/
      • %SuperMap iDesktopX 产品包%/lib/
      • %SuperMap iDesktopX 产品包%/lib/Jars/
      • %SuperMap iDesktopX 产品包%/support/batJars/bdt-all-runtime.jar
      • %SuperMap iDesktopX 产品包%/support/browser/

  4. 选择对应JDK环境的启动配置：若JDK环境为1.8则启动配置选择MyStartUp，若JDK环境17，则选择MyStartUp_JDK17。
  5. 编译：单击IDEA工具栏中的 Run 或者 Debug 按钮启动编译，编译成功后将自动启动 SuperMap iDesktopX。

相关主题

工程模版

插件配置概述

界面配置

功能区配置

配置文件菜单

配置状态栏

配置右键菜单

配置浮动窗口

属性信息